home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / pdcurs21.zip / README < prev    next >
Text File  |  1993-01-18  |  6KB  |  140 lines
  1.  
  2.                              PDCurses 2.0
  3.                   (Public Domain Curses for DOS and OS/2)
  4.  
  5.  
  6. INTRODUCTION:
  7.  
  8.        Well, here it finally is; PDCurses v2.0.
  9.        
  10.        PDCurses v2.0 is an almost total rewrite of PCCurses 1.4 done by John
  11.        'Frotz' Fa'atuai, the previous maintainer.
  12.        
  13.        This version has been tested with Microsoft C v6.0, QuickC v2.0 and
  14.        Borland C++ 2.0 under DOS and Microsoft C v6.0 and TopSpeed c v3.02
  15.        under OS/2 2.0. Also the library has been compiled successfully with
  16.        emx 0.8e, C Set/2 and Watcom 9.
  17.        Most testing was done with the large memory model where applicable.
  18.        The large memory model is probably the best model to use.
  19.        
  20.        The amount of testing has not been as extensive as I would have
  21.        liked, but demands on releasing a product have outweighed the
  22.        product's quality. Nothing new with that !!
  23.        Hopefully with wider circulation, more bugs will be fixed more quickly.
  24.        
  25.        I have included just 1 makefile which is suitable for dmake 3.8 for
  26.        both DOS and OS/2. The makefile does not rely on customisation of the
  27.        dmake.ini file.
  28.        
  29.        If you discover bugs, and especially if you have fixes, please let me
  30.        know ASAP.
  31.        
  32.        The source to the library is distributed as a zip file made with zip
  33.        1.9. You will need Info-ZIP unzip 5.0 to unzip.
  34.        Follow the directions below to compile the library.
  35.  
  36. DIRECTIONS:
  37.  
  38.        1.Create a new directory in which to unzip pdcurs20.zip. This will
  39.          create a curses directory and a number of subdirectories containing
  40.          source code for the library and utilities and the documentation.
  41.  
  42.        2.Make changes to the makefile where necessary:
  43.          Change the MODEL or model macro to the appropriate value (if it
  44.          applies to your compiler). Use model for Borland compilers.
  45.  
  46.          Change any paths in the defined macros to be suitable for your
  47.          compiler.
  48.  
  49.        3.Invoke DMAKE [-e environment_options] [target]
  50.        
  51.          where environment_options are:
  52.  
  53.                OS (host operating system)
  54.                COMP (compiler)
  55.                OPT (optimised version or debug version) - optional. default Y
  56.                TOS (target operating system) - optional. default OS
  57.  
  58.                see the makefile for valid combinations
  59.  
  60.                targets: all, demos, lcursesd.lib, manual...
  61.                
  62.                NB. dmake is case sensitive with targets, so those environments
  63.                that use an upper case model value (eg MSC) MUST specify the
  64.                library target as for eg. Lcursesd.lib
  65.  
  66.                The makefile is by default set up for Borland C++. The use of
  67.                -e environment_options override these defaults. Of you prefer
  68.                you can just change the defaults in the makefile and invoke it
  69.                without the -e switch.
  70.  
  71. OTHER NOTES:
  72.  
  73.        The documentation for the library is built into each source file,
  74.        a couple of specific doc files and the header files. A program is
  75.        supplied (manext) to build the manual. This program gets compiled
  76.        when you build the documentation.
  77.        
  78.        To generate the library response file correctly, I had to write a
  79.        quick and dirty program (buildlrf) to achive this. Originally the
  80.        makefiles just had statements like: "echo -+$(OBJ)\$* & >> $(LRF)"
  81.        which appended a suitable line to the response file. Unfortunately
  82.        under some combinations of makefiles and command processors (eg.
  83.        nmake and 4DOS) the & would get treated as stderr and the echo
  84.        command would fail.
  85.        
  86.        The original source for PDCurses that I received from the previous
  87.        maintainer contained support for the FLEXOS operating system. Not
  88.        having access to it, I could not test the changes I made so its
  89.        support has fallen by the wayside. If you really need to have PDCurses
  90.        running under FLEXOS, contact me and I will see what can be arranged.
  91.  
  92. COMPILER-SPECIFIC NOTES:
  93.  
  94.        Microsoft C
  95.        -----------
  96.        It is possible with MSC 6.0 to build the OS/2 libraries and demo
  97.        programs from within DOS. This is the only case where it is possible
  98.        to specifiy the value of TOS on the command line to be OS2 and the
  99.        value of OS be DOS.
  100.  
  101.        C Set/2
  102.        -------
  103.        I have only tested the library using the migration libraries. I doubt
  104.        that the demo programs will work without them.
  105.  
  106.        emx
  107.        ---
  108.        Testing has been done with 0.8e of emx together with the 16_to_32
  109.        libraries.
  110.        The emx\lib directory should include the vio32.lib and kbd32.lib
  111.        libraries from the 16_to_32 package.
  112.  
  113. BUGS and UNFINISHED BUSINESS:
  114.  
  115.        PDC_set_ctrl_break() function does not work under OS/2.
  116.        wprint() and PDC_Print() do not work under OS/2.
  117.        The file todo.man in the doc directory also lists those functions of
  118.        System V 3.2 curses not yet implemented. Any volunteers ?
  119.  
  120. ACKNOWLEGEMENTS:
  121.  
  122.        John 'Frotz' Fa'atuai, the previous maintainer for providing an
  123.        excellent base for further development.
  124.        John Burnell (johnb@kea.am.dsir.govt.nz), for the OS/2 port.
  125.        John Steele, Jason (finally NOT a John) Schumate....
  126.        for various fixes and suggestions.
  127.        Eberhardt Mattes (author of emx) for allowing code based on his
  128.        C library to be included with PDCurses.
  129.        Several others for their support, moral and actual.
  130.  
  131.  
  132. Good luck, Mark
  133.  
  134. ------------------------------------------------------------------------
  135. Mark Hessling                          email: M.Hessling@itc.gu.edu.au
  136. DBA, ITS                               phone: + 61 7 875 7691
  137. Griffith University                    fax:   + 61 7 875 7787
  138. Nathan 4111
  139. Qld Australia                          *** PDCurses maintainer ***
  140.